home *** CD-ROM | disk | FTP | other *** search
/ The Fatted Calf / The Fatted Calf.iso / Applications / GraphicViewers / pCD / Source / hpcdtoppm.0.4 / hpcdtoppm.man < prev    next >
Text File  |  1993-03-23  |  5KB  |  164 lines
  1. ..TH hpcdtoppm 1 " 16 March 1993"
  2. ..IX hpcdtoppm
  3. ..SH NAME
  4. hpcdtoppm v0.4 - convert a Photo-CD file into a portable pixmap
  5. ..SH SYNOPSIS
  6. ..B hpcdtoppm
  7. [options] pcd-file [ppm-file]
  8. ..SH DESCRIPTION
  9. Decodes a Photo-CD Image file or Overview file.
  10. Image files you can find on the Photo-CD in photo_cd/images, they are named
  11. as "imgnnnn.pcd", where nnnn is a 4-digit-number. The Overview file is at
  12. photo_cd/overview.pcd . If there is no output filename given, output will be
  13. printed to stdout. hpcdtoppm stands for "Hadmut's pcdtoppm" to make it
  14. distinguishable in case someone else is building the same thing and
  15. calling it pcdtoppm.
  16. ..IX GIF
  17. ..SH OPTIONS
  18. ..TP
  19. ..B -x
  20. Overskip Mode. Works on Base/16, Base/4, Base and 4Base. In Photo-CD
  21. images the luma channel is stored in full resolution, the two chroma
  22. channels are stored in half resolution only and have to be interpolated.
  23. In the Overskip Mode the chroma channels of the next higher resolution are
  24. taken instead of interpolating. To see the difference, generate one ppm with
  25. and one ppm without this flag. Use pnmarith to generate the difference image
  26. of these two images. Call ppmhist for this difference or show it with xv
  27. (push the HistEq button in the color editor).
  28. ..TP
  29. ..B -s
  30. Apply simple sharpness-operator on the Luma-channel.
  31. ..TP
  32. ..B -d
  33. Do not show the complete image, but only the decompressed difference.
  34. It works only on the 4Base and the 16Base resolution. It does not
  35. have any deeper sense, but it was simple to implement and it shows what
  36. causes different sizes of image files.
  37. ..TP
  38. ..B -i
  39. Give some information from the fileheader to stderr. It works only for 
  40. Image files. (It is not working correctly, just printing some strings.)
  41. ..TP
  42. ..B -m
  43. Show the phases of decoding to stderr.
  44. ..TP
  45. ..B -crop
  46. Try to cut off the black frame which is sometimes scanned
  47. at the image borders. The image size shrinks.
  48. ..TP
  49. ..B -pos
  50. Print the file relative start position of the data for
  51. the current resolution.
  52. ..TP
  53. ..B -rep
  54. Try to jump over reading errors in Huffman code. 
  55. ..TP
  56. ..B -n
  57. Don't rotate the image.
  58. ..TP
  59. ..B -r
  60. Rotate the picture clockwise for portraits.
  61. ..TP
  62. ..B -l
  63. Rotate the picture counter-clockwise for portraits.
  64. ..TP
  65. ..B -a
  66. Try to find out the image orientation byself. This doesn't work
  67. for overview files yet. It is very experimental and depends on
  68. one byte. Please tell me if it doesn't work.
  69. ..TP
  70. ..B -vert
  71. Vertical flip.
  72. ..TP
  73. ..B -hori
  74. Horizontal flip.
  75. ..TP
  76. ..B -ppm
  77. Write rgb image in ppm-format.
  78. ..TP
  79. ..B -pgm
  80. Write grayscale image in pgm-format.
  81. ..TP
  82. ..B -ycc
  83. Write ycc image in ppm-format.
  84. ..TP
  85. ..B -ps
  86. Write rgb image in postscript.
  87. ..TP
  88. ..B -eps
  89. Write rgb image in encapsulated postscript.
  90. ..TP
  91. ..B -psg
  92. Write grayscale image in postscript.
  93. ..TP
  94. ..B -epsg
  95. Write grayscale image in encapsulated postscript.
  96. ..TP
  97. ..B -pl f
  98. Set left position of Postscript image to f.
  99. ..TP
  100. ..B -pb f
  101. Set bottom position of Postscript image to f.
  102. ..TP
  103. ..B -pw f
  104. Set width of Postscript image to f.
  105. ..TP
  106. ..B -ph f
  107. Set height of Postscript image to f.
  108. ..TP
  109. ..B -c0
  110. Don't correct the image.
  111. ..TP
  112. ..B -c-
  113. Do a correction (darker). Hardware and taste dependend.
  114. ..TP
  115. ..B -c+
  116. Do a correction (brighter). Hardware and taste dependend.
  117. ..TP
  118. ..B -1 | -Base/16 | -128x192
  119. Extract the Base/16 size picture (size 128x192 pixels). Note that you
  120. can only give one size option.
  121. ..TP
  122. ..B -2 | -Base/4 | -256x384
  123. Extract the Base/4 size picture.
  124. ..TP
  125. ..B -3 | -Base | -512x768
  126. Extract the Base size picture.
  127. ..TP
  128. ..B -4 | -4Base | -1024x1536
  129. Extract the 4Base size picture.
  130. ..TP
  131. ..B -5 | -16Base | -2048x3072
  132. Extract the 16Base size picture.
  133. ..TP
  134. ..B -0 | -Overview | -O
  135. Extract all pictures from an Overview file. A ppmfilename must be given. If the
  136. given name is "foo", the files are named "foonnnn", where nnnn is a 4-digit number.
  137. Since they are stored in Base/16 format, they are extracted in this format.
  138. ..TP
  139. ..B -C d
  140. Extract all pictures from an Overview file. A ppmfilename must be given. If the
  141. given name is "foo", the files are named "foonnnn", where nnnn is a 4-digit number.
  142. Since they are stored in Base/16 format, they are extracted in this format.
  143.  
  144.  
  145. ..PP
  146.  
  147. ..SH BUGS
  148. hpcdtoppm seems to ignore the read protection. :-)
  149. The informations i have are quite vague and this program
  150. was developed by starring at the hex-dumps and the famous 
  151. trial-and-error-method. If anything
  152. doesn't work, please send me a report and perhaps you could try to
  153. find out, why it doesn't work.
  154. ..SH "SEE ALSO"
  155. ppm(5), ppmquant(1), ppmtopgm(1), ppmhist(1), pnmarith(1), ppmtorgb3(1), xv(1)
  156. ..SH AUTHOR
  157. Copyright (c) 1992, 1993 by Hadmut Danisch (danisch@ira.uka.de).
  158. Permission to use and distribute this software and its
  159. documentation for noncommercial use and without fee is hereby granted,
  160. provided that the above copyright notice appear in all copies and that
  161. both that copyright notice and this permission notice appear in
  162. supporting documentation. It is not allowed to sell this software in 
  163. any way. This software is not public domain.
  164.